OfficeCLI 集成：CLI 助力 PPT 设计
你会学到：用命令行创建、编辑、监看 PowerPoint/Word/Excel 文档——OfficeCLI 的安装与 30 秒上手、watch 实时预览工作流、文件"被锁定"的原理（常驻会话）、与 Claude Code 集成创建"模板学习" skill、用公司模板生成同风格 PPT 的实战与效果复盘，以及模板批量复刻的底层机制（dump / batch / merge）。
是什么：为 AI Agent 打造的命令行 Office 套件
先纠正一个容易以讹传讹的说法：视频里说"Office 官方出的王炸工具"——它不是微软官方产品。OfficeCLI 是开源团队 iOfficeAI 的项目（GitHub 约 33k star（2026-11-07 核实），C# 编写），"官方"的准确含义是 OfficeCLI 官方（官网与官方文档）。这不影响它的价值：
- 单二进制：.NET 运行时内嵌，免装 Microsoft Office、零依赖，macOS / Linux / Windows 全平台
- 为 AI Agent 设计：每条命令支持
--json确定性输出、路径化寻址（/slide[1]/shape[2]）、结构化错误码自带修复建议 - 核心杀手锏是渲染：内置从零实现的高保真 HTML 渲染引擎，把 docx / xlsx / pptx 渲染成 HTML 或 PNG——让 AI 真正"看见"文档长什么样
最后一点是它区别于 python-docx 这类库的根本原因。没有渲染能力时，AI 生成幻灯片等于盲飞：它能读写文档对象模型，但看不出标题溢出了、两个形状重叠了。OfficeCLI 把"渲染 → 查看 → 修正"闭环做进了命令行，CI、Docker、无显示器的服务器上都能跑。
安装
# macOS / Linux 一键脚本
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
# Homebrew（macOS / Linux）
brew install officecli
# npm（全平台，安装原生二进制的包装器）
npm install -g @officecli/officecli
# Windows（PowerShell）
irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex
# 或 Scoop
scoop install officecli
officecli --version
bash
装完执行一次 officecli install：它会把二进制放进 PATH，并自动检测本机的 AI 编码工具（Claude Code、Cursor、Windsurf、GitHub Copilot 等），把自带的 SKILL.md 装进它们的 skill 目录——你的 AI 助手立刻就会用这套命令，零额外配置。
也可以直接把 skill 喂给任何 agent：
curl -fsSL https://officecli.ai/SKILL.md。
30 秒上手：堆积木式做 PPT
对照官方文档逐句执行，感受"往文件里堆积木"的过程：
# 1. 创建空白演示文稿（此时是个空文件）
officecli create deck.pptx
# 2. 启动实时预览——浏览器打开 http://localhost:26315
officecli watch deck.pptx
# 3. 另开一个终端，添加一页
officecli add deck.pptx / --type slide --prop title="Hello, World!"
# 4. 往第一页加一个文本框（位置、字体、字号、颜色全是参数）
officecli add deck.pptx '/slide[1]' --type shape \
--prop text="Revenue grew 25%" --prop x=2cm --prop y=5cm \
--prop font=Arial --prop size=24 --prop color=FFFFFF
# 5. 查看结果
officecli view deck.pptx outline # 大纲视图
officecli view deck.pptx html # 渲染成独立 HTML（资源内联）
officecli view deck.pptx screenshot -o /tmp/deck.png # 逐页 PNG（多模态模型可直接读）
officecli get deck.pptx '/slide[1]/shape[1]' --json # 任意元素的结构化 JSON
# 6. 收尾：常驻会话落盘
officecli close deck.pptx
bash
watch 是这条工作流的灵魂：每执行一条 add / set / remove，浏览器即时刷新。你获得了对文件的实时监看，AI 获得了视觉反馈环——把 watch 页面截图喂回去，它就能自己发现"字太小""内容溢出"并修正。
文件"被锁定"的原理：常驻会话模式
初次使用容易困惑：create 出来的文件用 Word/WPS 打开提示被其他程序锁定，而且是空的。这不是 bug，是**常驻会话（Resident Mode）**的设计：
officecli open之后文档常驻内存（走命名管道，近零延迟），磁盘写入被推迟- 其他程序要读文件前，先
officecli save（落盘但保持常驻）或officecli close（落盘并释放） - 空闲 2-10 秒会自适应自动落盘；流水线场景可设
OFFICECLI_RESIDENT_FLUSH=each让每条命令都落盘
记一条规则：AI 用 officecli 改完、你要用其他工具打开之前，先 save/close。
GUI 选项：AionUi
官方推荐的图形界面是 AionUi 桌面应用——形似 ChatGPT 桌面版的对话工具，内置二十余个专业助手（Word/PPT/Excel/表单生成等），底层由 OfficeCLI 驱动，可在设置里选择本机的 Claude Code 等作为后端模型。适合不想碰命令行的同事。
对开发者更推荐命令行方式：模型因此具备直接编写 Office 文档的能力，才能编排进 skill、hook 和 CI 流水线——GUI 是给人用的终点，CLI 是给 AI 用的起点。
与 Claude Code 集成：创建"模板学习" skill
集成有两条路：
- MCP：
officecli mcp claude一行注册，全部文档操作变成 MCP 工具（也支持 cursor / vscode / lmstudio / opencode） - Skill：让 Claude Code 读官方文档后自己写一个"模板学习"skill：
为我创建一个 skill：先学习 OfficeCLI 是如何使用的
（有哪些命令和参数，官方文档：https://github.com/iOfficeAI/OfficeCLI）。
我后续的目的是：用这个 skill 对特定模板的 PPT 或 Word 进行格式上的学习，
生成类似风格的 Office 文档。
markdown
注意这段提示词的结构：先学工具（读官方文档）→ 再说明目的（模板学习）。AI 创建 skill 时会把 OfficeCLI 的命令语义、路径语法、渲染用法都沉淀进 SKILL.md，之后"照着这个模板做一份新文档"这类自然语言就能直接触发。
实战：把课程笔记做成公司模板风格的 PPT
第一步：准备一份"风格样本"模板
这是效果好坏的关键，有明确的操作技巧：
- 把公司 PPT 里承载主要格式的部分提炼出来——封面、标题版式、正文版式
- 风格相同的幻灯片删掉，只保留风格不同的：十页封面风格一致的只留一页，把不同版式各留一页
- 得到一份精简的"风格样本"——信息密度高、无冗余，AI 提取样式时干扰最小
第二步：一句话生成
把 notes.md 做成一份该模板风格的 PPT，输出到当前目录。
markdown
第三步：效果复盘（诚实记录）
实测（2026-10）结果：PPT 成功生成、结构完整，但整体字号偏小、部分样式读取不全——AI 从模板提取设计 token 的过程仍有不确定性。这正是 watch 存在的意义：开实时预览，追加迭代提示词（"正文字号提到 20""标题用模板第 2 页的版式"），边看边改收敛到目标。模板学习是概率性的，人工验收不可省。
模板复刻的底层机制：dump / batch / merge
上面的 skill 之所以能"学习模板"，底层靠 OfficeCLI 的两个原语：
dump / batch——结构 100% 复刻。dump 把任意文档（或任意子树：一页幻灯片、一张表格、一个段落、样式部件）序列化成可重放的 batch JSON；batch 把它重放到新文档上——版式完全一致，只改文字内容。发票、周报、证书、合同的批量生产走这条路：
officecli dump 模板.pptx -o blueprint.json # 整份文档
officecli dump 模板.docx /body/tbl[1] -o table.json # 只要那张表
officecli batch 新文档.docx --input blueprint.json # 重放
bash
merge——占位符填充。模板里写 {{key}}，一条命令用 JSON 数据填充，覆盖段落、表格单元格、形状、页眉页脚、图表标题。设计一次（贵），量产 N 次（便宜、确定性、零 token 成本）——避免 AI 每次从零重生成导致 N 份版式各不相同：
officecli merge invoice-template.docx out-001.docx --data '{"client":"Acme","total":"$5,200"}'
bash
课程的 officecli-templater skill 就建立在这两个原语上，提供两种模式：结构复刻（dump → 重放，只改文字）与风格提炼（从模板提取配色/字体/字号/间距等设计 token，应用到全新结构的文档）。
其他能力速览（与本章的呼应）
| 能力 | 说明 | 呼应 |
|---|---|---|
| Word 域原生支持 | MERGEFIELD / REF / PAGEREF / SEQ / STYLEREF 等 22+ 种域可直接写入 | 04节手工构造 OOXML 域的痛苦，这里有命令级替代 |
| Mermaid 图表 | mermaid 流程图/时序图 → 原生可编辑形状，任意 mermaid 类型 → 高保真 PNG | 01-03节的图表直接进 Word/PPT |
| LaTeX 公式 | 公式以 LaTeX 输入，OMML 双向转换 | 数学类文档 |
| Excel 引擎 | 350+ 内置函数写入即算（写 =SUM(A1:A2) 直接得到值）、一条命令建透视表 | 报表自动化 |
| 批量与原子性 | batch 多命令一次过，默认原子（任一失败整体回滚） | CI 流水线 |
小结
- OfficeCLI = 开源的命令行 Office 套件（iOfficeAI 出品，非微软官方）：单二进制、免装 Office、为 AI Agent 设计
- 核心价值是内置 HTML 渲染引擎——AI 从"盲写文档"变成"看着改文档"，
watch（localhost:26315）是人与 AI 共用的实时反馈环 - 文件被锁定/为空是常驻会话的正常行为：跨工具读取前先
save/close - 集成路径：
officecli install自动把 SKILL.md 装进 Claude Code 等工具；进阶玩法是"模板学习"skill——dump/batch 结构复刻、merge 占位符量产 - 模板准备的诀窍：提炼封面与标题版式、同风格幻灯片删到只剩一页；AI 提取样式有不确定性，watch + 迭代 + 人工验收缺一不可
相关章节：04-如何固定docx的输出风格（docx 格式保留与域）；第6章（PPT 生成工具全景，本节是其中"CLI 路线"的深入）
↑